home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / KEYBOARD / PSCRN43.ARJ / A86-PS.DOC next >
Text File  |  1991-11-11  |  11KB  |  253 lines
  1.  
  2.  
  3.            Displaying P-Screen's .ASM Screens From Your Programs
  4.  
  5.                       A86 assembler for P-Screen
  6.                       (V3.22   January 25, 1990)
  7.  
  8.  
  9.          A86 is Copyright 1990, Eric Isaacson   All Rights Reserved
  10.  
  11.               P-Screen is Copyright 1988-1991, Rob W. Smetana
  12.                            All Rights Reserved
  13.  
  14.  
  15.  
  16.       P-Screen lets you save screens in .ASM form which you can then
  17.       "assemble" (compile) and LINK with your programs.  But when we
  18.       added this feature, we realized that some of P-Screen's users
  19.       might have no way to assemble their screens into .OBJ files.
  20.       Not to worry . . .
  21.  
  22.  
  23.       Through special arrangements with Eric Isaacson (author of the
  24.       A86 assembler, Zipkey and other user-supported programs) we've
  25.       included a copy of A86 for your trial use in assembling P-Screen's
  26.       .ASM screens.  You may use either A86 or MASM to assemble your
  27.       screens.  A86 is much faster than MASM, and consumes just 23k of
  28.       disk space (compared with MASM's 100k+).  But the choice is yours.
  29.  
  30.  
  31.       NOTE:  We urge you to obtain the full version of A86 from a BBS, a
  32.       shareware distributor, or from Mr. Isaacson himself.  This brief
  33.       discussion ONLY shows you how to use A86 to assemble P-Screen's
  34.       ASM screens.  It does NOT explain A86's other features or advantages.
  35.       Please get the full version for it's complete documentation and
  36.       the other features Eric includes.
  37.  
  38.  
  39.  
  40.  
  41.                                                                              
  42.  
  43.      ============================ LICENSE ============================
  44.  
  45.  
  46.          A86 is Copyright 1990, Eric Isaacson   All Rights Reserved
  47.  
  48.               P-Screen is Copyright 1988-1991, Rob W. Smetana
  49.                            All Rights Reserved
  50.  
  51.  
  52.  
  53.  
  54.       =================================================================
  55.  
  56.       Below are Eric Isaacson's guidelines for trying this A86 package.
  57.  
  58.       =================================================================
  59.  
  60.       This A86 package is provided under the following conditions:
  61.  
  62.       You may execute the A86.Com program in this package in order
  63.       to evaluate it.  If you decide that you want to continue using
  64.       A86 assembler beyond the trial perion of 30 days, you must become
  65.       a registered user by sending $50 US ($52 if you are outside
  66.       North America) to:
  67.  
  68.                              Eric Isaacson
  69.                         416 E. University Avenue
  70.                        Bloomington, IN 47401-4739
  71.  
  72.       For your convenience, I now accept Visa and MasterCard, by
  73.       telephone.  My number is (812) 339-1811.
  74.  
  75.       When you register we'll send you the latest version of A86 on a
  76.       5.25 inch disk.   We'll also send you the A86LIB tool, available
  77.       only to registered users.  You may order further updates for
  78.       $10 US, or $12 US if you are overseas.  Once you register for
  79.       this package, you are registered for all future versions -- you
  80.       have permanent rights to execute A86 on one computer.  As long
  81.       as I'm in business, you can get the latest version for just the
  82.       update fee.
  83.  
  84.       We also offer the D86 debugging tool.  Normally it's also $50.
  85.       But when you order both A86 and D86 at the same time, I charge
  86.       $80 ($82 overseas) for both.
  87.  
  88.                                                        continued . . .
  89.                                                                            
  90.  
  91.       A86 License  (continued)
  92.  
  93.       I also offer a printed version of the manual covering both A86
  94.       and D86 (an on-disk manual is always included).  If you order
  95.       with your registration the manual is an extra $10 to the U.S.,
  96.       $15 overseas. If you've already registered and now want the
  97.       manual, add another $10 ($12 overseas) for the update disk that
  98.       the manual is bundled with.  There is a limit of one manual per
  99.       computer registered (except you may reorder when there is a
  100.       substantial revision to the manual).
  101.  
  102.       Indiana residents must add sales tax.  At the current rate of 5%,
  103.       the prices for Indiana residents are $52.50 for either A86 or D86,
  104.       $63 one product with manual, $84 both products, $94.50 both
  105.       products with manual, $21 manual if already registered.
  106.  
  107.       Educational institutions and training facilities MUST be registered
  108.       in order to use A86 in courses.  Contact me for special terms.
  109.  
  110.       Companies and government agencies MUST be registered in order to
  111.       use A86 for their work.  Again, contact me for special terms.
  112.  
  113.       =================================================================
  114.  
  115.       NOTE:  Just to clarify, you'll register A86 with Eric Isaacson.
  116.  
  117.       You'll register P-Screen with Rob W. Smetana.  P-Screen's manual
  118.       has an order form and information on registering P-Screen.
  119.  
  120.       =================================================================
  121.  
  122.  
  123.       Rob W. Smetana                   Eric Isaacson
  124.       Pro~Formance                     416 E. University Avenue
  125.       132 Alpine Terrace               Bloomington, IN 47401-4739
  126.       San Francisco, CA  94117
  127.       (415) 863 - 0530                 (812) 339 - 1811
  128.  
  129.                                                                            
  130.  
  131.       =============  A Word About P-Screen's ASM Screens  =============
  132.  
  133.  
  134.       We're finding P-Screen's ASM screens to be terrific!  They're
  135.       v-e-r-y fast and easy to use.  And since we use one screen-
  136.       restore routine for everything (library, ASM and normal screen
  137.       save/restores), using ASM screens adds very little overhead to
  138.       your programs.
  139.  
  140.       But it's sometimes not obvious when one should:  1) draw a screen
  141.       manually; 2) use an ASM screen; or display it from a library.
  142.       Here are some guidelines we're developing in our own programs.
  143.  
  144.        * First, while we're developing programs, we always display most
  145.          screens from screen libraries, preserving memory for code.  When
  146.          we compile the program, we simply comment out the CALLs to the
  147.          library screen display routine, and un-REM the CALL below it to
  148.          our ASM or in-line screen display routine.  For example:
  149.  
  150.          displayscreen ("mylib", "myscreen", errcode)   -- from a library
  151.          'myscreen                                      -- ASM screen
  152.  
  153.        * Screens that are critical to our program must be IN our program.
  154.          This includes menus, dialog boxes, warnings or error messages
  155.          and mandatory help screens.  We display ALL other screens from
  156.          screen libraries (help screens, introductions or farewell).
  157.  
  158.        * When a screen is simple, it's often most efficient to draw it
  159.          manually in your program.  Examples might be a window with just
  160.          a few lines of text.  This also gives you the flexibility to
  161.          simply change your code to change colors, text or positions.
  162.  
  163.        * But with complex screens, it's often more efficient to use ASM
  164.          screens.  That's because complex screens require so much code
  165.          to vary colors, patterns and textures and locate and print text.
  166.  
  167.                                                                            
  168.  
  169.  
  170.                            ASM versus OBJ Screens
  171.  
  172.       Other screen design programs let you save .OBJ files that you
  173.       LINK directly with your program -- you needn't assemble/compile
  174.       them first.
  175.  
  176.       We chose to provide you with .ASM screens for one simple reason:
  177.       to give you flexibility!
  178.  
  179.        * ASM screens are simple ASCII files you can edit with any
  180.          word processor or editor.  You can edit ASM screens to:
  181.  
  182.          - Change where the screen is displayed (assuming it's
  183.            a sub-screen, not a full screen).
  184.  
  185.          - Choose which screen-restore proceedure you want to use:
  186.            CompRestPlus  -or- our newer screen restore proceedure
  187.            which lets you "mask" colored screens so they're viewable
  188.            on monochrome, composite or laptop monitors.
  189.  
  190.        * You can "archive" ASM screens (using ZIP, PAK, LHarc or ARC) to
  191.          retain permanent, easily-edited copies and to preserve disk
  192.          space.  Then, you can change them without needing P-Screen.
  193.  
  194.          Note:  We urge you to ALWAYS save a copy of each screen in a
  195.          screen library.  That way you can always edit it and save it
  196.          as an ASCII, COM or ASM file.  And since P-Screen compresses
  197.          screens, this extra convenience and security consumes little
  198.          disk space.
  199.  
  200.                                                                            
  201.  
  202.  
  203.                      Creating and Using ASM Screens
  204.                      ==============================
  205.  
  206.       Here's how easy it is to create screens you LINK with your
  207.       programs, then just CALL them to display them.
  208.  
  209.        1. Create a screen in P-Screen and save it to a screen library.
  210.           We urge you to ALWAYS save screens to libraries so you can
  211.           easily edit them later.
  212.  
  213.  
  214.        2. Save your screen to an ASM file by pressing <F2> them <M>.
  215.  
  216.           - Note:  before you press <F2> move your cursor to the top
  217.             left corner of the area you want to save.
  218.  
  219.           - After you press <M>, move the cursor to the bottom right
  220.             corner and press <cr>.
  221.  
  222.           - Now give P-Screen a screen name.  Do NOT include hyphens
  223.             or numbers in your screen name.  Neither MASM nor A86 will
  224.             accept names that begin with numbers or contain hyphens.
  225.             Use the underscore if you need a separator (e.g. my_scrn).
  226.  
  227.           - Let's say you saved a screen named "myscreen."
  228.  
  229.  
  230.        3. Exit P-Screen and assemble your screen with A86 or Masm:
  231.  
  232.             masm myscreen;        -- note the semi-colon
  233.                  -or-
  234.             a86 myscreen.asm +o   -- no semi; +o means .OBJ file, not .COM
  235.  
  236.  
  237.           Note:  Masm assumes you're assembling an ".asm" file and
  238.           doesn't require the ".asm" extension.  With a86, you MUST
  239.           specify the ".asm" extension.
  240.  
  241.  
  242.        4. Add a simple CALL to your program to display your screen.
  243.  
  244.             call myscreen     -or-    call myscreen (#)
  245.  
  246.  
  247.        5. Finally, LINK your screen(s) to your program and run it.
  248.  
  249.             bc myprog /o;
  250.             link /noe myprog + myscreen,,nul, (include here the QB/PDS
  251.                                                and 3rd-party libraries
  252.                                                you need);
  253.